package com.xiaoh.dormitoryrepairreportbackend.model.dto.common;

import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data;

import java.io.Serializable;
import java.util.List;

/**
 * 通用分页响应DTO
 * 支持游标分页的同时提供完整分页信息
 *
 * @param <T> 数据类型
 */
@Data
@Schema(description = "分页响应信息")
public class PageResponse<T> implements Serializable {

    /**
     * 当前页数据列表
     */
    @Schema(description = "当前页数据列表")
    private List<T> records;

    /**
     * 当前页码（用于传统分页显示）
     */
    @Schema(description = "当前页码", example = "1")
    private Long current;

    /**
     * 每页大小
     */
    @Schema(description = "每页大小", example = "10")
    private Long size;

    /**
     * 总记录数
     */
    @Schema(description = "总记录数", example = "100")
    private Long total;

    /**
     * 总页数
     */
    @Schema(description = "总页数", example = "10")
    private Long pages;

    /**
     * 是否有下一页
     */
    @Schema(description = "是否有下一页")
    private Boolean hasNext;

    /**
     * 下一页的游标ID（用于游标分页）
     */
    @Schema(description = "下一页的游标ID，用于游标分页")
    private Long nextCursor;

    /**
     * 无参构造函数
     */
    public PageResponse() {
    }

    /**
     * 全参构造函数
     */
    public PageResponse(List<T> records, Long current, Long size, Long total, Long pages, Boolean hasNext, Long nextCursor) {
        this.records = records;
        this.current = current;
        this.size = size;
        this.total = total;
        this.pages = pages;
        this.hasNext = hasNext;
        this.nextCursor = nextCursor;
    }

    /**
     * 创建分页响应的静态工厂方法
     *
     * @param records    当前页数据
     * @param current    当前页码
     * @param size       每页大小
     * @param total      总记录数
     * @param nextCursor 下一页游标
     * @param <T>        数据类型
     * @return 分页响应对象
     */
    public static <T> PageResponse<T> of(List<T> records, Long current, Long size, Long total, Long nextCursor) {
        PageResponse<T> response = new PageResponse<>();
        response.setRecords(records);
        response.setCurrent(current);
        response.setSize(size);
        response.setTotal(total);
        
        // 计算总页数
        Long pages = (total + size - 1) / size;
        response.setPages(pages);
        
        // 判断是否有下一页
        Boolean hasNext = current < pages;
        response.setHasNext(hasNext);
        response.setNextCursor(nextCursor);
        
        return response;
    }

    /**
     * 创建空分页响应
     *
     * @param current 当前页码
     * @param size    每页大小
     * @param <T>     数据类型
     * @return 空分页响应对象
     */
    public static <T> PageResponse<T> empty(Long current, Long size) {
        return of(List.of(), current, size, 0L, null);
    }

    private static final long serialVersionUID = 1L;
}
